home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / program / swag9705.zip / BXP03A.ZIP / BXP.DOC < prev   
Text File  |  1994-08-04  |  3KB  |  70 lines
  1.   -------------------------------------------------------
  2.   Documentation for the BXP (Binary to Pascal+XX) utility
  3.   -------------------------------------------------------
  4.  
  5.   BXP converts a binary file -- eg. MYFILE.ZIP -- into a text
  6.   file.  The text file can be processed to restore the original
  7.   binary file. This allows the sharing of binary files via text
  8.   mediums such as BBS echoes & electronic mail. BXP uses an "XX"
  9.   encoding scheme to offer an efficient 3-to-4 byte ratio.
  10.  
  11.   The text file produced by BXP is Turbo Pascal source code, so no
  12.   special decoder is needed: The original binary file is recreated
  13.   when the TP source is compiled & executed. The filename extension
  14.   of the BXP-produced source code is PXS, and you can compile it
  15.   without renaming by invoking TP as TURBO MYFILE.PXS.
  16.  
  17.   The syntax for invoking BXP is "BXP [d:][path]<FileName>" where
  18.   [d:] is an optional drive, [path] is the optional path, and
  19.   <FileName> is the required file name of the input binary file.
  20.   Wildcard naming, of the input file & path, may be used to save
  21.   typing or process multiple files. BXP writes PXS file(s) to the
  22.   current directory & path by default.
  23.  
  24.   Example: to encode the binary file MYFILE.ZIP you would type ...
  25.     BXP MYFILE.ZIP
  26.   ... which will create MYFILE.PXS on the default disk & directory.
  27.  
  28.   BXP encoding can be aborted by tapping a CTRL key. BXP also aborts
  29.   upon any file i/o error.
  30.  
  31.   BXP supports output redirection and piping. You may redirect BXP
  32.   output to any valid DOS device or file:
  33.   * To see how many lines of TP source code will be created from
  34.     file MYFILE.ZIP, without producing any actual disk output...
  35.       BXP MYFILE.ZIP > NUL
  36.   * To append the output of BXP to any existing text file, such as
  37.     REPLY.TXT ...
  38.       BXP MYFILE.ZIP >> REPLY.TXT
  39.   * To view BXP output, with paging, just "pipe" to MORE (there's no
  40.     output to your disk) ...
  41.       BXP MYFILE.ZIP | MORE
  42.  
  43.   BXP isn't a bulk file encoder: BXP is intended for modest-sized
  44.   binary files, for BBS posting, no larger than approximately 44k.
  45.   Larger files will be denied. The size of the original binary file
  46.   can be seen in the BXP-output TP source code BlockWrite function.
  47.  
  48.   You should avoid files which encode into more than the reasonable
  49.   /normal size of one message. Posting of any encoded files must be
  50.   done only if allowed by the Network and conference host, and only
  51.   in moderation in all cases.
  52.  
  53.   ALWAYS compress any file(s) before encoding & posting using BXP --
  54.   this will minimize bandwidth and add transmission error detection.
  55.  
  56.   BXP is free/no-charge to all.  No one may profit ($$$) by BXP.
  57.  
  58.   Current version, as of Aug.03.1994, is 0.3a (BXP.COM = 2242 bytes).
  59.  
  60.   If you have problems with, or questions about, BXP please leave me
  61.   a message in any of the popular BBS network Pascal conferences (eg.
  62.   RIME TP), or e-mail me at the Internet or FidoMail address below.
  63.  
  64.   Greg Vigneault
  65.  
  66.   Internet(Greg.Vigneault@westonia.com)
  67.   Fido(1:250/636)
  68.   Millennium Technologies, Box 7169, Stn.A, Toronto, Canada M5W 1X8.
  69.  
  70.